ソースジェネレータ　ＳＯＵＲＣＥＲＹ ――――――――――――――――――――――――――――――――――――――― Ｏｈ！Ｘ　１９８８年１２月号掲載 Ｓ−ＯＳ　ＳＷＯＲＤ マシン語　ＳＯＵＲＣＥＲＹ．ＳＯＳ 　　　　　　０３０００Ｈ−０４７ＦＦＨ　Ｓ：０３０００Ｈ ソース　　ＳＯＵＲＣＥＲＹ．ＡＳＣ 起動方法 ＳＯＵＲＣＥＲＹ．ＳＯＳをロード Ｊ３０００ コールドスタート　０３０００Ｈ ホット　スタート　０３００３Ｈ ――――――――――――――――――――――――――――――――――――――― お待たせしました。 ＺＩＮＧに代わるＳ−ＯＳ用の高機能ソースジェネレータの登場です。 大きなオブジェクトプログラムも半自動的にソース生成可能。 もちろん、 オフセット機能付きですので3000Ｈからのものでも大丈夫。 皆さん活用してください。 ・―　　　　　　　　　　　　　　　―・ ｜　　ソースジェネレータってなに？　｜ ・―　　　　　　　　　　　　　　　―・ このプログラムはマシン語のプログラムを エディタアセンブラＺＥＤＡでアセンブルできる ソースプログラムに変換するためのツールです。 たとえば、Ｏｈ！Ｘに掲載されているような、 マシン語プログラムは通常ダンプリストで入力しますね。 しかし、ダンプリストをながめていても、 プログラムがなにをやっているかというのは、 なかなかわからないものです。 ソースリストが掲載されていれば、 それを参考にアルゴリズムを読んでいくこともできますが、 自分なりにプログラムを変更しようとすると パッチあて（変更部分を外に出してツギハギをすること）せざるをえず、 プログラムが汚くなり混乱のもとになります。 こんなとき、ソースリストがあれば なんの問題もなくプログラムの修正ができ、 なによりもそれをソフトウェア資産として、 ほかのプログラム開発に役立てることもできるでしょう。 ソースプログラムから 16進のオブジェクトプログラムが作れるなら、 オブジェクトプログラムから もとのソースプログラムが作れないか？ こういう観点から登場したのが ソースジェネレータというツールなのです。 Ｓ−ＯＳ用のソースジェネレータにはこれまで ＺＩＮＧというものがありました。 しかし、ＺＩＮＧはもうほとんど入手不可能ですし、 必ずしも使い勝手のよいものではありません。 加えて、ＺＥＤＡがＺＥＤＡ３までバージョンアップされ、 デバッガにもＴＲＡＤＥという強力なものが現れているのに、 ソースジェネレータはＺＩＮＧしか発表されていません。 そこで、今回ＺＩＮＧベースに大幅な機能アップを試みてみました。 それがこのＳＯＵＲＣＥＲＹです。 ・―　　　　　　　　　　　　　　　―・ ｜　　　　　入力と実行　　　　　　　｜ ・―　　　　　　　　　　　　　　　―・ ＭＡＣＩＮＴＯ−Ｃなどのマシン語入力ツールを用いて リスト１のとおりに入力してください。 当然ながら、各ブロックごとに チェックサムとＣＲＣチェックバイトを よく確認するのを忘れないでください。 実行は3000Ｈのコールドスタート、 3003Ｈのホットスタートアドレスに ジャンプすることで行われます。 ロード直後には必ずコールドスタートヘ、 前回の作業を継続して行いたいときには ホットスタートヘジャンプしてください。 起動するとカーソルが点滅しコマンド入力待ちの状態になります。 ここで使用できるコマンドについて解説しましょう。 Ｌ［＊ｏｒ／］ａｄｒ１［ａｄｒ２］ アドレスで指定した範囲をラベルつきで逆アセンブルします。 もっともラベルといっても、 原作者のつけたラベルは知りようがありませんので、 アドレスに＃マークをつけたもので代用されます。 Ｌの後ろに／をつけると、 両面表示と同時にメモリ上にソースジェネレートを行います。 Ｌの後ろに＊をつけたときはソースジェネレートのみを行います。 また最終アドレスは省略可能です。 Ｎ 逆アセンブルを再開します。 Ｌコマンドでソースの生成中メモリ不足などでエラーが発生したり、 ブレイクによって中断されたとき、 このコマンドで逆アセンブルを再開することができます。 たとえば、大きなオブジェクトはエラーが出るまでソース生成を行い、 そのたびにＳコマンドでソースをセーブ、 ソース生成の再開をしていけば分割逆アセンブルすることができます。 Ｘ［ａｄｒ］ Ｌ、Ｎコマンドで生成するソースの格納アドレスを設定します。 アドレスを省略すると現在のソース格納状況を表示します。 コールドスタート時には4E00Ｈが設定されます。 Ｏ　ａｄｒ Ｌ、Ｍ、Ｄ、Ｆコマンドでのオフセットアドレスを指定します。 たとえば、3000Ｈて動作するプログラムを A000Ｈから読み込んでいる場合は、 　O7000 　L3000 とすれば、ちゃんと3000Ｈから動作するプログラムとして 逆アセンブルできます。 Ｍ［Ｂ or Ｗ or Ｍ or Ｓ］［ａｄｒ１　ａｄｒ２］ 指定範囲をデータエリアとして登録します。 ＭＢ、ＭＷ、ＭＭ、ＭＳの各コマンドで指定された部分は それぞれＤＢ、ＤＷ、ＤＭ、ＤＳの形式でデー夕として出力されます。 アドレスを省略すると現在登録されている データエリアのアドレスを表示します。 ＆［ａｄｒ］ 指定されたアドレスを先頭アドレスとして 登録されているデータエリアの登録を解除します。 アドレスを省略するとすべてのデータエリアの登録を解除します。 Ｃ［ａｄｒ］［ＣＯＤＥ］［ＳＩＺＥ］ 特殊サブルーチンの指定解除を行います。 ここでいう特殊サブルーチンとは Ｓ−ＯＳの＃ＭＰＲＮＴのように ＣＡＬＬ文の直後にデータを持つようなサブルーチンのことです。 　　Ｃ　ａｄｒ　ＳＩＺＥ　　　(１) 　　Ｃ　ａｄｒ　00　ＣＯＤＥ　(２) のような書式でサブルーチンを登録します。 このとき、 (１)では指定されたアドレスに続くＳＩＺＥバイト分のエリアをデータとみなし、 (２)では後続のデータ数が不定であるサブルーチンに適用するもので、 データ数を０に指定し、その直後にデータのエンドコードを表記してください （データは16進２桁で指定）。 ＴＲＡＤＥのＥＳコマンドとほぼ同様ですが、 アドレスにラベル名を使うことはできません。 (１)はＳ−ＯＳの#PAUSE、 (２)は#MPRNTのようなルーチンに使用してください。 ＳＯＵＲＣＥＲＹでは以上の２つのルーチンは 初めから登録されていますが、 例として#MPRNTを登録してみましょう。 この場合、 　　C1FE2 00 00 となります。 Ｃの直後に#PRNTのアドレス、続いてデータ数不定の00、 エンドコードの00を並べているわけです。 データを省略すると（アドレスだけ）、 そのアドレスのデータ登録をクリアし、 Ｃのみを入力すると現在登録されている すべての特殊サブルーチンを表示します。 Ｓ　ｆｉｌｅｎａｍｅ 生成したソースを指定のファイル名でセーブします。 Ｄ　ａｄｒ１［ａｄｒ２］ アドレスで指定した範囲のダンプリストを表示します。 最終アドレスを省略すると最初の 128バイトだけ表示します。 表示内容はそのままスクリーンエディット可能です。 当然、エディット時もオフセットは有効です。 Ｆ　ａｄｒ１　ａｄｒ２　ＤＡＴＡ…… 指定範囲からＤＡＴＡをサーチし、アドレスとともに出力します。 データは複数個指定可能で 16進数かダブルクォーテーションでくくった文字列で指定します。 Ｊ　ａｄｒ 指定したアドレスヘジャンプします。 ＃ このコマンドを実行するたびにプリンタヘの出力をＯＮ／ＯＦＦします。 ！ Ｓ−ＯＳのホットスタートヘジャンプします。 ・―　　　　　　　　　　　　　　　―・ ｜　ＳＯＵＲＣＥＲＹのソースを作る　｜ ・―　　　　　　　　　　　　　　　―・ それではソースジェネレータを使ってみましょう。 ここでは、ＳＯＵＲＣＥＲＹ自身のソースを生成してみます。 とりあえず、ＳＯＵＲＣＥＲＹを起動してみてください。 まず、データエリアの登録を行います。 Ｍコマンドを用いて以下のように設定を行ってください。 　　MB39C9 39CA 　　MM44AE 4714 　　MB4715 4728 　　MW4729 476C 　　MB476D 478C 　　MS478D 次に特殊サブルーチンのセットを行います。 ＳＯＵＲＣＥＲＹ内部では特殊サブルーチンを２ヵ所で使っています。 両方ともエンドコードが00Ｈなので、 　　C4069 00 00 　　C415B 00 00 とします。 これで下準備は終わりです。 もう一度データを確認して、 　　L/3000 47FF でソースジェネレートしてください。 メモリオーバーが発生したら、適当なファイル名をつけてセーブし、 Ｎコマンドで操作を再開してください （ＭＺ−80Ｋ／Ｃでなければメモリオーバーを起こさないはずですが）。 ソースジェネレートが終了したら、セーブを行います。 ソースは4E00Ｈから出力されていますので、 そのままＺＥＤＡを起動してソースをのぞいてみましょう。 ＺＥＤＡのエディットモードから、 　　X4E00 　　R 　　BT のように操作してください。 ただし、このソースは実行中のプログラムから強引に生成したものですから、 ワークエリアの内容が書き換わっています。 使用するときには本誌に掲載されているソースに従ってワークを書き換え、 ラベルなども整えておいてください。 ・―　　　　　　　　　　　　　　　―・ ｜　　　　プログラムについて　　　　｜ ・―　　　　　　　　　　　　　　　―・ このプログラムは1985年８月号掲戟の ソースジェネレータＺＩＮＧを基本として 新しく作り直されたものです。 ＺＩＮＧに対して大きく改良された点は、 データエリアの処理です。 従来のＭコマンドを機能別に分けたことや Ｃコマンドを追加したことにより、 データエリアの分離が格段に楽になりました。 次の特徴としては ＺＥＤＡの疑似マクロに対応していることが挙げられます。 逆アセンブルしてみるとわかると思いますが、 リスト中に“IF〜JR”などの命令を見ることができます。 ＳＯＵＲＣＥＲＹでは、“IF〜THEN(ELSE)”を除く すべてのマクロ命令をサポートしています （好き嫌いはあるでしょうが）。 プログラムを3000Ｈから配置したことで、 メモリを最大限に使用でき、 ソース作成中はオブジェクトエリアのチェックを行っているので、 ソースとオブジェクトが重なる心配もありません。 さらに特殊ワークをチェックして８Ｋバイト以上あれば 内部ルーチンを切り換え、検索を高速化しています。 ＺＩＮＧを使っていた人は逆アセンブル速度に驚くことでしょう。 そのほか、基本的な操作はＺＩＮＧと変わらないので、 これまでＺＩＮＧを使っていた人でも 気軽に使うことができるはずです。 とにかく、久々に発表されたソースジェネレータです。 マシン語のプログラムの解析や改造など 皆さんなりの使い方で役立ててください。